.TH E1432_GET_REGISTER_ADDRESS 3 E1432
.SH NAME
e1432_get_register_address \- Get memory mapped address of E1432 register
.IX e1432_get_register_address(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_get_register_address(E1432ID hw, SHORTSIZ16 ID,
                                      LONGSIZ32 regOffset,
                                      volatile SHORTSIZ16 **addr)
.cE
.SH DESCRIPTION
\fIe1432_get_register_address\fR returns the address of a register on
a single E1432, identified by one of its channels, \fIID\fR.  This
address can be used to directly access the register in question.
\fBNote:\fR bus errors that occur when accessing a register from an
address returned by this function are not trapped; so extreme care
must be exercised when using the address returned.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is the ID of a single channel.

\fIregOffset\fR is the offset of the register relative to the base
address of the E1432.  Register offsets have defines of the form
\fBE1432_\fI<register_name>\fB_REG\fR in the file \fBe1432.h\fR.  For
instance, E1432_VXI_ID_REG is at register offset 0.  The list of E1432
registers, and their detailed description, may be found in the
hardware appendix.

\fIaddr\fR is a pointer to a pointer to a SHORTSIZ16.
.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_read_register
.ad
